HCL Notes and Domino Application Development wiki: Agents: Using Fiddler to monitor HTTP traffic in Domino Java agents

Using Fiddler to monitor HTTP traffic in Domino Java agents

Added by ~Delores Lopfooteroden | Edited by ~Autumn Minjipyteroden on April 5, 2012 | Version 2

Actions ▼

Sometimes you need to see ALL the HTTP/HTTPS traffic that goes out of your computer and/or returns to it. While you can write debug code to log the URLs your code uses and the "payloads" you send and receive, viewing the actual HTTP headers is more complicated.

Tags: Java Agents Debug HTTP

Read my blog post to see how to easily configure the JVM to proxy all traffic through Fiddler, a free utility for monitoring web traffic:

http://bobzblog.com/tuxedoguy.nsf/dx/using-fiddler-to-monitor-http-traffic-in-domino-java-agents

To answer the question in the blog article, yes, this is possible with Notes client agents run from within the client JVM. (Starting in ND8, I believe)

The Notes.INI parameter JavaUserOptionsFile refers to a text properties file that can contain JVM startup parameters. So, setting this line to

JavaUserOptionsFile=jvm_params.properties

on startup the JVM will attempt to load the settings found in the file \jvm_params.properties

To work with Fiddler, the contents of jvm_params.properties should contain (at least):

-Dhttp.proxyHost=127.0.0.1

-Dhttp.proxyPort=8888

To capture HTTPS traffic, first follow the instructions provided on the Fiddler website. Then, the self-signed cert created by Fiddler will need to be imported into the client JVM trusted cert store (\jvm\lib\security\cacerts)